home *** CD-ROM | disk | FTP | other *** search
/ Java Interactive Reference Guide / Java Interactive Reference Guide.iso / autorun / java_d.dir / 00124_Field_12a.txt < prev    next >
Text File  |  1980-01-11  |  11KB  |  1,420 lines

  1. Methods
  2.  
  3.  
  4.  
  5. The following methods are available in JavaScript: 
  6. abs acos alert anchor asin assign atan back big blink blur bold ceil charAt clear      clearTimeout click close confirm cos eval exp fixed floor focus fontcolor fontsize forward getDate getDay      getHours getMinutes getMonth getSeconds getTime getTimeZoneoffset getYear go indexOf italics lastIndexOf link log max min      open parse pow prompt random round select setDate setHours setMinutes setMonth setSeconds setTimeout setTime setYear sin      small sqrt strike sub submit substring sup tan toGMTString toLocaleString toLowerCase toString toUpperCase UTC write writeln 
  7.  
  8.  
  9. ------------------------------------------------------------------------
  10.  
  11.  
  12. abs method
  13.  
  14.  
  15.  
  16. Returns the absolute value of its argument. 
  17.  
  18. Syntax
  19.  
  20.  
  21.  
  22. abs(arg)
  23.  
  24.  
  25.  
  26.  
  27. Applies to
  28.  
  29.  
  30.  
  31. Math 
  32.  
  33. Examples
  34.  
  35.  
  36.  
  37. xxx Examples to be supplied. 
  38. ------------------------------------------------------------------------
  39.  
  40.  
  41. acos method
  42.  
  43.  
  44.  
  45. Returns the arc cosine (in radians) of its argument. 
  46.  
  47. Syntax
  48.  
  49.  
  50.  
  51. acos(arg)
  52.  
  53.  
  54.  
  55.  
  56. Applies to
  57.  
  58.  
  59.  
  60. Math 
  61.  
  62. Examples
  63.  
  64.  
  65.  
  66. xxx Examples to be supplied. 
  67.  
  68. See also
  69.  
  70. asin, atan, cos, sin, tan methods 
  71. ------------------------------------------------------------------------
  72.  
  73.  
  74. alert method
  75.  
  76.  
  77.  
  78. Displays an Alert dialog box with a message and an OK button. 
  79.  
  80. Syntax
  81.  
  82.  
  83.  
  84. alert("message")
  85.  
  86.  
  87.  
  88.  
  89. The argument message is any string. 
  90.  
  91. Description
  92.  
  93.  
  94.  
  95. Use the alert method to display a message that does not require a user decision. The message argument specifies a message that the dialog box contains. 
  96.  
  97. Applies to
  98.  
  99.  
  100.  
  101. window 
  102.  
  103. Examples
  104.  
  105.  
  106.  
  107. In the following example, the testValue function checks the name entered by a user in the text element of a form to make sure that it is no more than eight characters in length. This example uses the alert method to prompt the user of an application to enter a valid value. 
  108.  
  109.  
  110. function testValue(textElement) {
  111.    if (textElement.length > 8) {
  112.       alert("Please enter a name that is 8 characters or less")
  113.    }
  114. }
  115.  
  116.  
  117. You can call the testValue function in the onBlur event handler of a form's text element, as shown in the following example: 
  118.  
  119. Name: <INPUT TYPE="text" NAME="userName" onBlur="testValue(userName)">/PRE>
  120.  
  121.  
  122.  
  123.  
  124.  
  125. See also
  126.  
  127.  
  128.  
  129.  
  130. confirm, prompt methods
  131.  
  132.  
  133. ------------------------------------------------------------------------
  134.  
  135.  
  136.  
  137.  
  138.  
  139. anchor method
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147. Causes the calling string object to be a named anchor by surrounding it with HTML anchor tags,  <A NAME=...><A>
  148.  
  149.  
  150.  
  151.  
  152.  
  153. Syntax
  154.  
  155.  
  156.  
  157.  
  158. string.anchor(name)
  159.  
  160.  
  161.  
  162. The argument name can be any string.
  163.  
  164.  
  165.  
  166.  
  167.  
  168. Description
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175. xxx Description to be supplied.
  176.  
  177.  
  178.  
  179.  
  180.  
  181. Applies to
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188. string
  189.  
  190.  
  191.  
  192.  
  193.  
  194. Examples
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201. xxx Examples to be supplied.
  202.  
  203.  
  204.  
  205.  
  206.  
  207. See also
  208.  
  209.  
  210.  
  211.  
  212. link method
  213.  
  214.  
  215. ------------------------------------------------------------------------
  216.  
  217.  
  218.  
  219.  
  220.  
  221. asin method
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229. Returns the arc sine (in radians) of its argument.
  230.  
  231.  
  232.  
  233.  
  234.  
  235. Syntax
  236.  
  237.  
  238.  
  239.  
  240. asin(arg)
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247. Applies to
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254. Math
  255.  
  256.  
  257.  
  258.  
  259.  
  260. Examples
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267. xxx Examples to be supplied.
  268.  
  269.  
  270.  
  271.  
  272.  
  273. See also
  274.  
  275.  
  276.  
  277.  
  278. acos, atan, cos, sin, tan methods
  279.  
  280.  
  281. ------------------------------------------------------------------------
  282.  
  283.  
  284.  
  285.  
  286.  
  287. assign method
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295. Sets location.href so you don't have to type "href"complements toString().
  296.  
  297.  
  298.  
  299.  
  300.  
  301. Syntax
  302.  
  303.  
  304.  
  305.  
  306. assign()
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313. Description
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320. Do not call the assign method. It exists so you can use 'location=...' instead of 'location.href=...'.
  321. xxx Description to be supplied.
  322.  
  323.  
  324.  
  325.  
  326.  
  327. Applies to
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. location
  335.  
  336.  
  337.  
  338.  
  339.  
  340. Examples
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347. xxx Examples to be supplied.
  348.  
  349.  
  350. ------------------------------------------------------------------------
  351.  
  352.  
  353.  
  354.  
  355.  
  356. atan method
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364. Returns the arc tangent (in radians) of its argument.
  365.  
  366.  
  367.  
  368.  
  369.  
  370. Syntax
  371.  
  372.  
  373.  
  374.  
  375. atan(arg)
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382. Applies to
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389. Math
  390.  
  391.  
  392.  
  393.  
  394.  
  395. Examples
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402. xxx Examples to be supplied.
  403.  
  404.  
  405.  
  406.  
  407.  
  408. See also
  409.  
  410.  
  411.  
  412.  
  413. acos, asin, cos, sin, tan methods
  414.  
  415.  
  416. ------------------------------------------------------------------------
  417.  
  418.  
  419.  
  420.  
  421.  
  422. back method
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430. Loads the previous URL in the history list.
  431.  
  432.  
  433.  
  434.  
  435.  
  436. Syntax
  437.  
  438.  
  439.  
  440.  
  441. back()
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448. Description
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455. This method performs the same action as a user choosing the Back button in the Navigator. The back method is the same as go(-1).
  456.  
  457.  
  458.  
  459.  
  460.  
  461. Applies to
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468. history
  469.  
  470.  
  471.  
  472.  
  473.  
  474. Examples
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481. xxx Examples to be supplied.
  482.  
  483.  
  484.  
  485.  
  486.  
  487. See also
  488.  
  489.  
  490.  
  491.  
  492. forward, go methods
  493.  
  494.  
  495. ------------------------------------------------------------------------
  496.  
  497.  
  498.  
  499.  
  500.  
  501. big method
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509. Causes the calling string object to be displayed in big font by surrounding it with HTML big font tags,  <BIG>and <BIG>
  510.  
  511.  
  512.  
  513.  
  514.  
  515. Syntax
  516.  
  517.  
  518.  
  519.  
  520. big()
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527. Description
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534. xxx Description to be supplied.
  535.  
  536.  
  537.  
  538.  
  539.  
  540. Applies to
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547. string
  548.  
  549.  
  550.  
  551.  
  552.  
  553. Examples
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560. xxx Examples to be supplied.
  561.  
  562.  
  563.  
  564.  
  565.  
  566. See also
  567.  
  568.  
  569.  
  570.  
  571. fontsize, small methods
  572.  
  573.  
  574. ------------------------------------------------------------------------
  575.  
  576.  
  577.  
  578.  
  579.  
  580. blink method
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588. Causes the calling string object to blink by surrounding it with HTML blink tags,  <BLINK>... <BLINK>
  589.  
  590.  
  591.  
  592.  
  593.  
  594. Syntax
  595.  
  596.  
  597.  
  598.  
  599. blink()
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606. Description
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613. xxx Description to be supplied.
  614.  
  615.  
  616.  
  617.  
  618.  
  619. Applies to
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626. string
  627.  
  628.  
  629.  
  630.  
  631.  
  632. Examples
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639. xxx Examples to be supplied.
  640.  
  641.  
  642.  
  643.  
  644.  
  645. See also
  646.  
  647.  
  648.  
  649.  
  650. bold, italics, strike methods
  651.  
  652.  
  653. ------------------------------------------------------------------------
  654.  
  655.  
  656.  
  657.  
  658.  
  659. blur method
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667. For password, text, and textArea, removes focus to the object.
  668.  
  669.  
  670.  
  671.  
  672.  
  673. Syntax
  674.  
  675.  
  676.  
  677.  
  678. blur()
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685. Description
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692. Use the blur method to remove focus from a specific form element.
  693.  
  694.  
  695.  
  696.  
  697.  
  698. Applies to
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705. password, text, textArea
  706.  
  707.  
  708.  
  709.  
  710.  
  711. Examples
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718. xxx Examples to be supplied.
  719.  
  720.  
  721.  
  722.  
  723.  
  724. See also
  725.  
  726.  
  727.  
  728.  
  729. focus, select methods
  730.  
  731.  
  732. ------------------------------------------------------------------------
  733.  
  734.  
  735.  
  736.  
  737.  
  738. bold method
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746. Causes the calling string object to be displayed as bold by surrounding it with HTML bold tags,  <B>... <B>
  747.  
  748.  
  749.  
  750.  
  751.  
  752. Syntax
  753.  
  754.  
  755.  
  756.  
  757. bold()
  758.  
  759. NOTE: For Beta4, use B() for this method.
  760.  
  761.  
  762.  
  763.  
  764.  
  765. Description
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772. xxx Description to be supplied.
  773.  
  774.  
  775.  
  776.  
  777.  
  778. Applies to
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785. string
  786.  
  787.  
  788.  
  789.  
  790.  
  791. Examples
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798. xxx Examples to be supplied.
  799.  
  800.  
  801.  
  802.  
  803.  
  804. See also
  805.  
  806.  
  807.  
  808.  
  809. blink, italics, strike methods
  810.  
  811.  
  812. ------------------------------------------------------------------------
  813.  
  814.  
  815.  
  816.  
  817.  
  818. ceil method
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826. Returns the least integer greater than or equal to its argument.
  827.  
  828.  
  829.  
  830.  
  831.  
  832. Syntax
  833.  
  834.  
  835.  
  836.  
  837. ceil(arg)
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844. Applies to
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851. Math
  852.  
  853.  
  854.  
  855.  
  856.  
  857. Examples
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864. xxx Examples to be supplied.
  865.  
  866.  
  867.  
  868.  
  869.  
  870. See also
  871.  
  872.  
  873.  
  874.  
  875. floor method
  876.  
  877.  
  878. ------------------------------------------------------------------------
  879.  
  880.  
  881.  
  882.  
  883.  
  884. charAt method
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892. Returns the character at the specified index.
  893.  
  894.  
  895.  
  896.  
  897.  
  898. Syntax
  899.  
  900.  
  901.  
  902.  
  903. charAt(index)
  904.  
  905.  
  906.  
  907. index is any integer from 0 to string.length() - 1.
  908.  
  909.  
  910.  
  911.  
  912.  
  913. Description
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920. xxx Description to be supplied.
  921.  
  922.  
  923.  
  924.  
  925.  
  926. Applies to
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933. string
  934.  
  935.  
  936.  
  937.  
  938.  
  939. Examples
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946. xxx Examples to be supplied.
  947.  
  948.  
  949.  
  950.  
  951.  
  952. See also
  953.  
  954.  
  955.  
  956.  
  957. indexOf, lastIndexOf methods
  958.  
  959.  
  960. ------------------------------------------------------------------------
  961.  
  962.  
  963.  
  964.  
  965.  
  966. clear method
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974. Clears the window.
  975.  
  976.  
  977.  
  978.  
  979.  
  980. Syntax
  981.  
  982.  
  983.  
  984.  
  985. clear()
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992. Description
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999. xxx Description to be supplied.
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005. Applies to
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012. document
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018. Examples
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025. xxx Examples to be supplied.
  1026.  
  1027.  
  1028. ------------------------------------------------------------------------
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034. clearTimeout method
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041. Cancels a timeout that was set with the setTimeout method.
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047. Syntax
  1048.  
  1049.  
  1050.  
  1051.  
  1052. clearTimeout(timeoutID)
  1053.  
  1054.  
  1055.  
  1056. timeoutID is a timeout setting that was returned by a previous call to the setTimeout method.
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062. Description
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069. xxx Description to be supplied.
  1070.  
  1071. Applies to
  1072.  
  1073.  
  1074. window
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080. Examples
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087. xxx Examples to be supplied.
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093. See also
  1094.  
  1095.  
  1096.  
  1097.  
  1098. setTimeout
  1099.  
  1100.  
  1101. ------------------------------------------------------------------------
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107. click method
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115. Simulates a mouse click on the calling form element.
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121. Syntax
  1122.  
  1123.  
  1124.  
  1125.  
  1126. click()
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133. Description
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140. The effect of the click method varies according to the calling element:
  1141. For button, reset, and submit, xxx.
  1142. For a radioButton, selects a radio button.
  1143. For a checkbox, checks the check box and sets its value to on.
  1144. For a selection, sets its value.
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151. Applies to
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158. button, checkbox, radioButton, reset, selection, submit
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164. Examples
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171. xxx Examples to be supplied.
  1172.  
  1173.  
  1174. ------------------------------------------------------------------------
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180. close method
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188. For document and window, closes the window. xxx Not yet implemented in Beta 4.
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194. Syntax
  1195.  
  1196.  
  1197.  
  1198.  
  1199. close()
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206. Description
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213. Document description to be supplied.
  1214.  
  1215.  
  1216.  
  1217. The close method closes the current window.
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223. Applies to
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230. document, window
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236. Examples
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243. Any of the following examples close the current window:
  1244. window.close()
  1245. self.close()
  1246. close()
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253. See also
  1254.  
  1255.  
  1256.  
  1257.  
  1258. open method
  1259.  
  1260.  
  1261. ------------------------------------------------------------------------
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267. confirm method
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275. Displays a Confirm dialog box with the specified message and OK and Cancel buttons.
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281. Syntax
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288. confirm("message")
  1289.  
  1290.  
  1291. The argument message is any string.
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297. Description
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304. Use the confirm method to ask the user to make a decision that requires either an OK or a Cancel. The message argument specifies a message that prompts the user for the decison. The confirm method returns true if the user chooses OK and false if the user chooses Cancel.
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310. Applies to
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317. window
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323. Examples
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330. This example uses the confirm method in the confirmCleanUp function to confirm that the user of an application really wants to quit. If the user chooses OK, the custom cleanUp() function closes the application.
  1331.  
  1332. function confirmCleanUp() {
  1333.    if (confirm("Are you sure you want to quit this application?")) {
  1334.       cleanUp()
  1335.    }
  1336. }
  1337.  
  1338. You can call the confirmCleanUp function in the onClick event handler of a form's pushbutton, as shown in the following example:
  1339. <INPUT TYPE="button" VALUE="Quit" onClick="confirmCleanUp()">/PRE>
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346. See also
  1347.  
  1348.  
  1349.  
  1350.  
  1351. alert, prompt methods
  1352.  
  1353.  
  1354. ------------------------------------------------------------------------
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360. cos method
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368. Returns the cosine of its argument. The argument is in radians.
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374. Syntax
  1375.  
  1376.  
  1377.  
  1378.  
  1379. cos(arg)
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386. Applies to
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393. Math
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399. Examples
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406. xxx Examples to be supplied.
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412. See also
  1413.  
  1414.  
  1415.  
  1416.  
  1417. acos, asin, atan, sin, tan methods
  1418.  
  1419.  
  1420. ------------------------------------------------------------------------